home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / scope / 026-050 / scopedisk42 / handshake / handshake.doc < prev    next >
Text File  |  1995-03-18  |  37KB  |  783 lines

  1. ***********
  2. *
  3. *
  4. * Handshake Version 2.12a.
  5. *
  6. *
  7. ***********
  8.  
  9. HandShake V2.12a. Summary of Features.
  10.  
  11.  
  12. If you want to see how this version of Handshake has changed from the
  13. previous versions please refer to the Version History section at the end
  14. of this document.
  15.  
  16. WHAT IS IT?
  17.  
  18. Handshake is the copyrighted property  ( (c) 1987, 1988) of Eric Haberfellner
  19.  
  20. Handshake is a Full featured VT52/100/102/220 terminal emulator for those
  21. people who really need it. I have taken great pains to support the full
  22. VT102 spec (VT102 is a superset of VT100) and most of the VT220 spec. I have
  23. no real way currently to test the full functionality of the VT220 emulation,
  24. so I am relying on my users to point out any errors. Please detail any
  25. problems that you find, and I will fix them for the next release.
  26.  
  27. I take no responsibility for the proper functioning of this program or for
  28. any damage to you or your business that may be caused by this program.
  29. (obligatory disclaimer.)
  30.  
  31. WHAT IS IT NOT?
  32.  
  33. Handshake doesn't try to be an all round, general purpose, modem program
  34. which supports a multitude of transfer protocols, a script language, etc.
  35. There are plenty of good programs out there which fulfill this need.
  36. Several Handshake users however claim they use it for all their
  37. communications and that handshake does more than many programs that make
  38. greater claims. See the review included in the ARC file.
  39.  
  40. IMPORTANT NOTE ABOUT DISTRIBUTION AND SHAREWARE
  41.  
  42. Feel free to use and distribute this program as you like, as long as it is
  43. not for commercial use. If you like it, use it and want to see it get
  44. better, please send a contribution of $25.00 to the address listed in the
  45. program's "About.." requester. Commercial users are urged to contact the
  46. author. Please do not alter or rename the distribution ARC file in any
  47. way if you pass it along or post it on a bulletin board. The current
  48. Handshake distribution ARC file is called HDSK212a.arc. This way people
  49. can tell what version of Handshake is on a BBS.
  50.  
  51. Future enhancements that I would like to do include ZMODEM file transfer
  52. protocol, perhaps make Handshake an AREXX host, multiple number dialing, etc,
  53. however I will have to see an increase in user support if I am going to do
  54. these things. If you like this product and use it send a contribution. This
  55. is not free software. It is SHAREWARE it has a cost that you are expected to
  56. pay if you use it. Let me know what features are important to you. If you
  57. feel that there are features missing that you would like to see, please let
  58. me know that as well. How would you feel if Handshake got even bigger?
  59. Is size a problem? How do you feel about overlays? Would having to do an
  60. assign in your startup-sequence make Handshake unusable or cumbersome to you?
  61.  
  62. COME ON PEOPLE TALK TO ME! I know that you are out there and using
  63. Handshake. If the support does not pick up I will have to start releasing
  64. crippled versions of Handshake, and only send the full featured non-freely
  65. distributable versions to people who contribute. I do not want to have to
  66. do this, it is contrary to my beliefs about SHAREWARE and people supplying
  67. quality software to others for low cost. I know it is a nuisance to have
  68. to walk to your chequebook and fill out a cheque, address an envelope, and
  69. mail it, but prove that you are someone that cares about SHAREWARE and wants
  70. it to continue. Make a statement, not just for me and my program, but for
  71. other SHAREWARE products that you use as well. The people who write these
  72. programs are highly skilled professionals in most cases who want to help
  73. other users. They deserve your support!
  74.  
  75. WHAT IS THIS DOCUMENT?
  76.  
  77. This document is a quick description of the features of Handshake paying
  78. particular attention to the less obvious aspects of Handshake so that an
  79. experienced user will be able to use the program. This document assumes
  80. that the user has experience with terminal programs and the Amiga.
  81. Especially the Intuition user interface ( Menus, requesters, etc. )
  82.  
  83. WHAT IS THIS DOCUMENT NOT?
  84.  
  85. This document is not a course on telecomunications and modem usage it assumes
  86. some familiarity with telecommunications and terminal programs.
  87. If you are not familiar with terminal programs or the Amiga user
  88. interface, find a friend who is and ask him/her to help you.
  89.  
  90. WHAT DO YOU NEED TO RUN HANDSHAKE?
  91.  
  92. An Amiga with 512K or more. At least version 1.2 of Kickstart and Workbench.
  93. THIS PROGRAM WILL NOT WORK WITH VERSION 1.1 OR EARLIER OF AMIGADOS.
  94. Hardware to connect to the other computer. This may consist of only a cable
  95. if you are locally wired, or a cable and a modem if you are accessing the
  96. other computer over the telephone. This program does work with memory
  97. expanded beyond 512K.
  98.  
  99. WHY SHOULD YOU USE HANDSHAKE?
  100.  
  101. If you have a requirement for FULL VT52/100/102/220 compatability and have
  102. not been satisfied by other programs which only do half the job, this is
  103. probably the program you have been looking for!
  104.  
  105. Here is a list of some of the features that Handshake offers:
  106.  
  107.     - Full 24/48 line display with title bar enabled! No more turning the
  108.       title bar on and off to see all 24 lines.
  109.  
  110.     - Full VT52 support. Every VT100 has a VT52 inside of it. So does
  111.       Handshake -- right down to the VT52 graphics character set.
  112.  
  113.     - VT102 Edit mode. Local insert and deletes.
  114.  
  115.     - VT220 Emulation. Including downloadable character sets. It works
  116.       great with VMS APL.
  117.       
  118.     - VT220 7 or 8 bit control mode. Selectable erase etc.
  119.  
  120.     - Smooth or Jump scrolling.
  121.  
  122.     - Block or Underline see through reverse video cursor. Blinking or
  123.       non-blinking
  124.  
  125.     - Full VT100 Special Graphics Character Set.
  126.  
  127.     - Full double height and double width characters.
  128.  
  129.     - 132 character per line mode. It may be necessary to run preferences
  130.       and use the screen centering gadget a little to the left in order to
  131.       see the last few columns in 132 column mode.
  132.  
  133.     - Double height and width characters in 80 and 132 column mode.
  134.  
  135.     - All character modes. Normal, Bold, Reverse video, Underline and
  136.       Blinking in any combination.
  137.       
  138.     - Optional color mode. Uses ANSI color selection codes. Handy for
  139.       bulletin boards which support color.
  140.  
  141.     - Full keyboard support. This includes VT52 mode. Handshake handles the
  142.       escape sequences to turn auto repeat on and off and lock the
  143.       keyboard. No more run away cursors while in EDT under VMS etc.
  144.     
  145.     - As of release 1.60a Handshake supports the additional Amiga 500/2000
  146.       numeric keypad keys.
  147.  
  148.     - ASCII file transfer mode with user definable end-of-line translation
  149.       for both sending and receiving. No more carriage returns in your
  150.       received files (unless you want them).
  151.  
  152.     - XMODEM, XMODEM/CRC, YMODEM, YMODEM Batch, KERMIT/TEXT, KERMIT/8 BIT
  153.       BINARY and KERMIT/7 bit BINARY protocols for binaryfile transfers.
  154.  
  155.     - Six user definable function keys.
  156.     
  157.     - Dialing Support with a 20 Phone number Directory. Optional auto
  158.       redialing is available. System characteristics ( baud rate, data
  159.       bits, parity, stop bits ) can be specified in the dialing directory
  160.       entry. Auto redial can be specified in the directory entry. This
  161.       dialing mode is geared to Hayes compatible modems, although the user
  162.       can specify the dialing prefix ( ATDP or ATE0DT, etc. ).
  163.  
  164.     - Fast! Using a 95K text file captured from a VAX which was then sent
  165.       to Handshake from a local microcomputer, Handshake maintained a
  166.       throughput of 875 characters per second. This means that Handshake
  167.       can take characters as fast as your host can send them at 7200 baud,
  168.       and still look good at 9600. A real VT100 can't keep up at 9600
  169.       baud either. You can use the shareware BLITZFONTS program to get even
  170.       better performance.
  171.       
  172.     - Complete Workbench integration. Handshake can be started from the
  173.       Workbench. As you save parameter files, icons are optionally created.
  174.       These icons can be used to invoke Handshake later with the same
  175.       paremeters. You can even specify a host to dial immediately when the
  176.       icon is invoked. This feature can be turned off if you prefer the CLI
  177.       and do not want .info files cluttering up your disk.
  178.       
  179.     - The ability to capture screen images to an ASCII file or to a printer.
  180.       Just for you Toronto Real Estate Board Users. See, I do listen to my
  181.       users.
  182.       
  183.     - Handshake will optionally make use of the ARP file requester if
  184.       ARP.library is installed in the LIBS: directory of your workbench disk.
  185.  
  186. WHAT PROBLEMS ARE THERE WITH HANDSHAKE?
  187. *
  188. * PLEASE READ THIS SECTION!!
  189. *
  190. The VT220 mode does not support the Host Definable Keys feature. This will
  191. probably be in the next major release.
  192.  
  193. Line noise will sometimes select one of the special character sets (this
  194. happens with real VT100 terminals too). You can reselect the ASCII font
  195. by selecting the Terminal Type from the Terminal menu. For instance, if
  196. you are in VT102 mode, and you wish to reset the ASCII character set, just
  197. select the VT102 submenu.
  198.  
  199. Handshake takes up a lot of memory for its fonts and buffers. Handshake
  200. will run on a 512k system, but you may run into problems if you have
  201. a background utilities running (machii, virusx, etc). The best solution
  202. is to buy more memory. A 512k Amiga is really starving. However I intend
  203. to address this problem in a future release. Maybe a menu option to disable
  204. everything but the 80 column fonts.
  205.  
  206. You may find that you can not see the last two or three columns of 132 column
  207. mode. If this happens to you, run Preferences and move the screen centering
  208. gadget to the left a bit. This should fix the problem.
  209.  
  210. WHO DO YOU CALL WITH PROBLEMS, SUGGESTIONS, MAKE CONTRIBUTIONS TO ETC?
  211.  
  212. Me!
  213.     Eric Haberfellner,
  214.     57 Marble Arch Crescent
  215.     Scarborough, Ontario
  216.     CANADA
  217.     M1R 1W8
  218.  
  219.     Voice Phone (416) 757-1055 ( After Six P.M. EST please ).
  220.  
  221.     I am on available on BIX as ehaberfellner, and can be reached through
  222.     USENET at ...utgpu!mnetor!becker!haberfellner!eric
  223.  
  224. WHAT DO YOU NEED TO KNOW ABOUT HANDSHAKE TO USE IT NOW?
  225.  
  226. The follwing things about Handshake are not obvious so you should
  227. familiarize yourself with this section.
  228.  
  229.     * READ THIS NOTE.
  230.     * Handshake uses a 660 pixel wide screen instead of the usual 640 pixels.
  231.     * This means that the Handshake extends 20 pixels further to the right
  232.     * Than most screens. It may not be possible to seew the screen depth
  233.     * arrangement gadgets at the right of the title bar or the last 3 or 4
  234.     * columns of test in 132 column mode unless you run preferences and move
  235.     * the screen centering gadget a little to the left!!
  236.  
  237. Command line.
  238.  
  239.     Handshake can be invoked from the CLI. The general form of the command
  240.     line is illustrated below (parts in square brackets are optional):
  241.  
  242.     Handshake [-p parameter_file_name] [destination_name]
  243.  
  244.     The parameter file name is the parameter file to be used, if none is
  245.     specified the default file Handshake.parms is used.
  246.  
  247.     The destination name is the name of the remote computer to be dialed.
  248.     This name must be one that appears in dialing directory of the
  249.     parameter file being used and must be spelled exactly the same way it
  250.     is spelled in the dialing directory entry (Case of characters is not
  251.     significant).
  252.  
  253.     If the name in the dialing diretory entry ends in a '*' or the Auto
  254.     Redial menu selection is set in the parameter file, Handshake will keep
  255.     dialing the number until a connection is made. If the name in the
  256.     dialing directory entry ends in a '*', do not include the '*' on the
  257.     command line when specifying the destination name.
  258.  
  259.     If this dialing directory entry appeared in the default file
  260.     Handshake.parms:
  261.  
  262.     555-1234:1200,8,n,1 Fred's BBS*
  263.  
  264.     The following command line coule be used to call this BBS.
  265.  
  266.     Handshake "Fred's BBS"
  267.  
  268.     Note that the '"'s are necessary in this case because the name of the
  269.     BBS has a space in it.
  270.  
  271.     Here is another example.
  272.  
  273.     Handshake -p universities.parms UCLA
  274.  
  275.     This would dial the phone number associated with the descriptor UCLA
  276.     in the parameter file universities.parms
  277.  
  278.     For a complete description of dialing directory entries, see the
  279.     discussion later in this section
  280.  
  281. Workbench.
  282.  
  283.    Handshake can also be invoked from the Workbench. There is an icon which
  284.    looks like a terminal. Invoking this icon will cause Handshake to be
  285.    invoked with the parameters from Handshake.parms, or if this file does
  286.    not exist Handshake will use it's built in parameters.
  287.    
  288.    In the project menu there is an item "Create Icons". if you set this to
  289.    "Yes" Handshake will create a telephone icon every time that you save
  290.    the parameters. While Handshake is saving the parameters it will also
  291.    prompt you for a dialing descriptor which if specified will be used as
  292.    the initial dialing destination when the icon is invoked.
  293.    
  294.    CLI users will probably want to keep the "Create Icons" option set to
  295.    "No" so that their disks will not be cluttered with un-necessary .info
  296.    files.
  297.  
  298. Keyboard.
  299.  
  300.     VT100 Keys                Amiga Keys
  301.     ----------                ----------
  302.     Arrow keys                Arrow keys
  303.     
  304.     F1 through F4             F1 through F4 on all Amaigas
  305.                    or
  306.     F1                        Keypad ( on Amiga 500/2000
  307.     F2                        Keypad ) on Amiga 500/2000
  308.     F3                        Keypad / on Amiga 500/2000
  309.     F4                        Keypad * on Amiga 500/2000
  310.     
  311.     Keypad 0 through 9        Keypad 0 through 9 on all Amigas
  312.     Keypad .                  Keypad . on all Amigas
  313.     Keypad -                  Keypad - on all Amigas
  314.     Keypad ,                  RIGHT_ALT key on all Amigas **Watch for this**
  315.                    or
  316.     Keypad ,                  Keypad + on Amiga 500/2000
  317.     
  318.     Keypad Enter              Keypad Enter on all Amigas
  319.     
  320.     
  321.     
  322.  
  323.     VT220 Keys                Amiga Keys
  324.     ----------                ----------
  325.     Arrow keys                Arrow keys
  326.     
  327.     F1 through F4             F1 through F4 on all Amaigas
  328.                    or
  329.     PF1                       Keypad ( on Amiga 500/2000
  330.     PF2                       Keypad ) on Amiga 500/2000
  331.     PF3                       Keypad / on Amiga 500/2000
  332.     PF4                       Keypad * on Amiga 500/2000
  333.  
  334.     F1-F4                     Do not transmit any key codes and are not
  335.                               currently mapped.
  336.     F5                        RIGHT-AMIGA B on all Amigas
  337.     F6                        F1 on all Amigas
  338.     F7                        F2 on all Amigas
  339.     F8                        F3 on all Amigas
  340.     F9                        F4 on all Amigas
  341.     F10                       F5 on all Amigas
  342.     F11                       Escape on all Amiags
  343.     F13                       Any SHIFTED Arrow key on all Amigas
  344.     F12                       Backspace on all Amigas
  345.     F14                       F6 on all Amigas
  346.     F17                       F7 on all Amigas
  347.     F18                       F8 on all Amigas
  348.     F19                       F9 on all Amigas 
  349.     F20                       F10 on all Amigas
  350.     
  351.     FIND                      SHIFTED-Keypad 7 on all Amigas
  352.     INSERT HERE               SHIFTED-Keypad 8 on all Amigas
  353.     REMOVE                    SHIFTED-Keypad 9 on all Amigas
  354.     SELECT                    SHIFTED-Keypad 4 on all Amigas
  355.     PREV SCREEN               SHIFTED-Keypad 5 on all Amigas
  356.     NEXT SCREEN               SHIFTED-Keypad 6 on all Amigas
  357.     
  358.     Keypad 0 through 9        Keypad 0 through 9 on all Amigas
  359.     Keypad .                  Keypad . on all Amigas
  360.     Keypad -                  Keypad - on all Amigas
  361.     Keypad ,                  RIGHT-ALT key on all Amigas **Watch for this**
  362.                    or
  363.     Keypad ,                  Keypad + on Amiga 500/2000
  364.     
  365.     Keypad Enter              Keypad Enter on all Amigas
  366.  
  367.     The Back space and Del keys can be reversed with a TERMINAL menu option.
  368.  
  369. User Definable Function Keys.
  370.  
  371.     The function keys F5 through F10 are now user definable keys. There
  372.     is now a new menu item in the Porject menu, the "Function keys" item.
  373.     Selecting this option will cause the Function Key Edit Requester to
  374.     appear. Just type in the strings that you want the fucntion keys to
  375.     transmit. When you are finished, just select the ALL DONE gadget.
  376.     
  377.     There are two other gadgets on the Function Key Edit Requester. These
  378.     allow the user to specify which characters in the transmit strings should
  379.     be used to represent the carriage return and line feed keys. The default
  380.     values are the '~' for carriage return and '`' for line feed. Please
  381.     note that inorder to change these charcters it is necessary to delete the
  382.     character which appears in the gadget before typing in the new one.
  383.     
  384.     The function key definitions are saved along with the phone directory
  385.     and other options the the selected Handshake parameter file.
  386.  
  387. File Transfers.
  388.  
  389.     The "Receive/Transmit CR/LF as ..." menu options are only applicable to
  390.     the ASCII file transfer modes. These can be used to translate end of
  391.     line characters when sending to the other system. For instance, when
  392.     sending to a VAX which is receiving with the CREATE command, you
  393.     will want to send a carriage return to the  VAX at the end of each
  394.     line. Amiga text files have no carriage returns in them so lines are
  395.     terminated with line feed characters. By selecting the Transmit LF as
  396.     CR option Handshake will do the conversion for you.
  397.  
  398.     
  399.     As of version 1.30b you no longer have to terminate ASCII Receive
  400.     (capture) mode in order to do a binary file transfer. Handshake
  401.     will automatically suspend cpature mode while the transfer is taking
  402.     place and will restart it  when the transfer has completed.
  403.     
  404.     If you use the XMODEM, XMODEM/CRC or single file YMODEM binary file
  405.     transfer mode, be aware that the received file will probably have to
  406.     be truncated. This is because all files received by XMODEM are a
  407.     multiple of 128 bytes long. AmigaDos does not like these extra bytes.
  408.     There are several good public domain utilities available to strip
  409.     these bytes off the end of the file (TAILRID, for one). If you send
  410.     your files in ARC format then this is not a problem.
  411.  
  412.     Handshake also supports the YMODEM Batch protocol and KERMIT. Using 
  413.     these protocols lets you transfer multiple files in one trnasfer,
  414.     frees the receiving user from the necessity of having to enter the name
  415.     of the file being received, and results in files that have the same
  416.     length as the original file (No need to chop extra bytes off the end
  417.     of the file). Handshake does however ask the receiving user to specify
  418.     the directory path into which the received files should be placed. 
  419.     This directory path MUST end in a ":" or a "/". Some exapmles of valid
  420.     directory paths are:
  421.     
  422.        df0:
  423.        df1:source/
  424.        source/
  425.        :source/
  426.        vd0:source/headers/
  427.        RAM:download_files/
  428.        my_files:               /* In this case my_files must be a vilume
  429.                                   name or have been assigned with the
  430.                                   assign command.
  431.                                */
  432.     If you do not specify a directory path the files will be placed in the
  433.     current directory.
  434.     
  435.     When sending with YMODEM Batch protocol you can specify a file name as
  436.     usual, or use wildcards as well. Here are some sample YMODEM Batch
  437.     send file specifications:
  438.     
  439.        df0:source/my_file.c
  440.        ram:#?
  441.        df1:source/headers/#?.h
  442.        
  443.     You get the idea. YMODEM Batch or KERMIT will transfer all the specified
  444.     files to the receiver. It will send the file names, and the file lengths
  445.     as well.
  446.     
  447.     
  448.     Handshake now supports the KERMIT file transfer protocol. It is used in
  449.     much the same way as the YMODEM Batch protocol which also supports
  450.     multiple file transfers. There are three KERMIT modes. KERMIT 8 bit
  451.     Binary, KERMIT 7 bit Binary and KERMIT Text. Kermit 8 bit Binary requires
  452.     you to be connected with the other computer with 8 data bits. It will not
  453.     work with a seven bit connection. KERMIT 7 bit binary works with a 7
  454.     bit connection it uses the KERMIT binary escaping feature. This should
  455.     only be used if an 8 bit connection is unavailable, since it can really
  456.     slow down the transfer. KERMIT Binary protocols do image transfers, the
  457.     received or sent file is bit for bit identical with the original.
  458.     Kermit Text is used for text files, and will work with either a 7 bit or
  459.     8 bit connection. It should be used for text files only. The received
  460.     files will have no cariage returns at the end of the lines, only line
  461.     feeds. If you want the carigae returns, use one of the binary protocols
  462.     
  463.     For the protocol transfers and for the ASCII Send, Handshake pops up
  464.     two windows, one in its own screen and one in the workbench screen.
  465.     These windows provide information on the progress of the transfer.
  466.     The one in the Handshake screen can be used to abort the transfer
  467.     just by clicking on the close gadget in the upper left hand corner.
  468.     The window in the Workbench screen is provided so that during a long
  469.     file transfer you can use your multi-tasking Amiga to do other things
  470.     and not have to keep flipping back to handshake to see if the transfer
  471.     has completed.
  472.     
  473.     If you have the Audio Bell option enabled, You will hear a rising
  474.     sequence of notes for a successfull file transfer, and a falling
  475.     sequence of notes for an unsuccessfull file transfer.
  476.  
  477.  
  478. Dialing the Phone.
  479.  
  480.     In order to dial a number from the dialing directory ( Menu option 
  481.     "Dial Phone" ), click using the mouse on the small square gadget
  482.     immediately to the left of the number that you want to dial. Clicking
  483.     on the text of the number allows you to edit the entry, but not to
  484.     dial it.
  485.  
  486.     The dialing directory is saved to disk whenever you save the parameters
  487.     It is possible to have several diailing directories by using different
  488.     parameter files.
  489.     
  490.     Whenever Handshake goes into auto-dialing mode, it pops up a pair of
  491.     windows much like in file transfer mode to keep you informed of progress.
  492.     See the description in the file transfer section above.
  493.     
  494.     If the Audio bell feature is enabled, you will hear a four note
  495.     sequence to indicate that the connection has been completed.
  496.  
  497. Format of dialing directory entries.
  498.  
  499.     A dialing directory entry has the following general format. The parts
  500.     in the square brackets are optional. The * at the end of the line is
  501.     used to indicate auto redialing.
  502.  
  503.     telephone_number[:baudrate[,data_bits[,parity[,stop_bits]]]] [desc][*]
  504.  
  505.     Below are some sample dialing directory entries:
  506.  
  507.     123-4567                                      Simplest case. Dial the
  508.                                                   number using the current
  509.                                                   serial parameters.
  510.  
  511.     123-4567 Joe's BBS                            Same as above with a
  512.                                                   description.
  513.  
  514.     123-4567 *                                    Both of these will dial
  515.     123-4567 Joe's BBS*                           Until the other system
  516.                                                   Answers.
  517.  
  518.     123-4567:1200                                 Call the number changing
  519.                                                   baud rate to 1200 if
  520.                                                   necessary.
  521.  
  522.     123-4567:1200,8,n,1 Joe's BBS*                A biggie. Call Joe's
  523.                                                   until it answers using
  524.                                                   1200 baud, 8 data bits,
  525.                                                   no parity and 1 stop
  526.                                                   bit.
  527.                                                   
  528.     Valid parity characters are n=none, o=odd, e=even, m=mark and s=space.
  529.  
  530. Interlace.
  531.  
  532.     The Half screen interlace mode is intended to give you a full 24 line
  533.     VT100 Emulation in half a screen. This leaves you the other half to do
  534.     whatever you like, and still watch your terminal screen.
  535.  
  536.     The full screen interlace mode is useful in 132 column mode.
  537.     Readability of characters in interlaced mode may depend on your
  538.     selection of colors. (I find that black characters on a gray
  539.     background look just super ).
  540.  
  541.  
  542. HANDSHAKE VERSION HISTORY
  543.  
  544. Version 2.12a
  545.      - Cleaned up font support so that Handshake's fonts were not visible
  546.        to other applications in the system (i.e. Notepad).
  547.      - Fixed several downloadable font bugs which were reported by Joe
  548.        Trivers. Many thanks to Joe, who brought over a real VT220 to
  549.        demonstrate these bugs.
  550.      - 24 line half screen mode stopped working in the last version as
  551.        a result of the interlace bug fix. This has been corrected.
  552.      - Last version was not linked with a tiny _main, as a result a window
  553.        opened on the workbench when handshake was run from the workbench.
  554.        This version is correctly linked.
  555.      - Changed the default foreground colour in the colour mode to 7
  556.        instead of 1.
  557.  
  558. Version 2.11a
  559.      - Fixed the "Interlace WorkBench" bug reported by Joanne Dow. If
  560.        you were running Handshake in 48 line mode with an interlaced
  561.        workbench and flipped back to the workbench with the Amiga-M,N
  562.        keys junk would be displayed.
  563.        
  564. Version 2.10a
  565.      - Set default VT220 character set mapping to gr<-g2<-DEC special
  566.        character set.
  567.      - Fixed and improved the VT220 soft font support.
  568.      - Changed Backspace handling so that it does now not wrap to previous
  569.        when at the start of a line.
  570.      - Added menu item to transmit the answer back message.
  571.      - ASCII screen images (printed or filed) no longer have trailing blanks.
  572.      - Added close file option for the Save Screen submenu.
  573.      - ctrl-Z and ctrl-X now displayed as upside down ?.
  574.      - Fixed File IO Guru in BuildFullName.
  575.      - Cleaned up handling of IDCMP messages all over.
  576.      - Added default fourth colour for File requester. This can be edited
  577.        using the color edit in the project menu.
  578.      - Added menu item in the phone menu which lets the user dial without
  579.        first hanging up. This is required for some phone systems which
  580.        require multiple dials to reach a destination. Also some people did
  581.        not like the wait associated with waiting for the phone to hang up.
  582.      - General cleanup of dialing code.
  583.      - Fixed bug in locked line requester which caused it to hang.
  584.      - Fixed receive buffer overflow problem. Receive buffer now stands at
  585.        1536 bytes.
  586.      - Ymodem receives now correctly display received size when a
  587.        retransmitted block is encountered.
  588.      - Screen formats and colors are now set if a parameter file is loaded
  589.        once Handshake is already running.
  590.      - Added more VT220 control keys (3,4,5,6,7).
  591.      - Added support for mark and space parity.
  592.      - Added support for zero stop bits.
  593.      - File requesters for loading and saving parameters now only
  594.        display files which have a ".parms" extension. If a file name
  595.        without this extension is entered. it will be added.
  596.      - Removed WaitBOVP () calls and replaced them with WaitTOF () calls.
  597.        WaitBOVP () BUSY WAITS!! UGH.
  598.      - Replaced RJ's file requester with the ARP one. If ARP.library is not
  599.        available, fall back to old style plain requesters.
  600.      - Fixed the Special Graphics character set GURU reported by Joe Trivers.
  601.      - Added direct screen print to the "Save Image" submenu.
  602.      - Added Close File menu option for "Save Image" submenu.
  603.      - The "New File" option in the "Save Image" memu item no longer saves
  604.        the first image. You must explicitly save all images now with the
  605.        Write Sreen submenu item.
  606.      - Corrected spelling for "Successful"
  607.      - Sundry other small fixes.
  608.  
  609. Version 2.00a
  610.      - Incredible code changes from last version.
  611.      - Full VT200 support (actually VT220 except for User Definable Keys).
  612.      - Added RJ Mical's color editor so you can set and save colors. See
  613.        PROJECT menu.
  614.      - Added RJ Mical's file requester. All file names are now input using
  615.        this file requester.
  616.      - Made several code changes related to serial input to clean up the
  617.        lockup problem.
  618.      - See the new keyboard layout above. Some keys have moved to accomodate
  619.        VT200 support.
  620.      - Optinal 8 color mode for "ANSI" BBSs.
  621.      - Ability to save ASCII screen images to a file. See the Screen Image
  622.        menu item in the Project Menu.
  623.      - Fixed Backspace and delete handling. No longer affects CTRL-h.
  624.        
  625. Version 1.60a    Jan/88
  626.      - Massive code cleanup. Defined function prototypes for all functions in
  627.        the source. Compiled with Lattice v4.0. Since this version is such
  628.        a major reworking of the source and compiled with a new compiler,
  629.        I would like to hear back from users as quickly as possible if you
  630.        encounter any bugs.
  631.      - Function prototyping turned up a bug in VT102 insert line feature
  632.        which could have caused trashing of very low memory. Fixed.
  633.      - Tried to convert to 16 bit integers. Failed because of bugs in Lattice
  634.        v4.0. However the source is all set to go. Maybe next release if
  635.        Lattice fixes their bugs in getfnl(). This should speed things up
  636.        a bit more.
  637.      - Added support for the extra keys on the Amiga 500/2000 Keypad. These
  638.        can now be used as F1 through F4 and the VT100 keypad comma key. See
  639.        the text above.
  640.      - Added KERMIT 7 bit binary protocol for users who connect to host
  641.        system with 7 bit connections and want to transfer binary files very
  642.        slowly.
  643.      - Reversed PHONE and TRANSFER menus.
  644.      - Cleaned up XMODEM transfer protocol bugs. XMODEM wouldn't switch from
  645.        CRC to checksum properly.
  646.      - Improved dialing. Handshake now recognizes the baud rate that a
  647.        connection is made at from the CONNECT message. i.e. CONNECT 1200 or
  648.        CONNECT 2400 etc. It also recognizes the return codes BUSY, NO ANSWER,
  649.        NO DIALTONE and NO CARRIER if one of these is returned by the modem
  650.        it is displayed for 1 second on the STATUS line of the auto redial
  651.        window. Any of these codes is taken as a failure to connect.
  652.  
  653. Version 1.50a
  654.      - Added user definable function keys. keys F5 through F10 are now
  655.        available as user definable keys. See the documentation above.
  656.      - Kermit File transfer protocol added. See documentation above.
  657.      - Some characters were getting lost after file transfers. this is now
  658.        fixed.
  659.  
  660. Version 1.42a
  661.  
  662.      - Fixed the horrid "Beep forever" bug.
  663.      - Fixed the rename command in EXEC_ME for Handshake.rev.
  664.  
  665. Version 1.41a
  666.      - Fixed bug in YMODEM Batch protocol. It would work with another Amiga
  667.        running Handshake, but not with any other YMODEM Batch
  668.        implementations.
  669.  
  670. Version 1.40a
  671.      - Fixed the horrible dialing bug which appeared in v1.30b. Boy am I
  672.        embarassed. Dialing would not work unless AUTO REDIAL was selected.
  673.      - AmigaDos requesters now appear in the Handshake screen instead of
  674.        popping the Workbench screen to the front. Big improvement.
  675.      - YMODEM and YMODEM Batch file transfer protocols are here. See the
  676.        File transfer section of this document and the Binary Protocol
  677.        item of the TRANSFER menu.
  678.      - Added a bell. Handshake now beeps upon receipt of a BEL character.
  679.        Handshake also now gived an audio indication of file transfer
  680.        completion and connection in auto redial mode. The user can
  681.        select audio bell, visual bell, both or none. See the new Bell Type
  682.        item in the TERMINAL menu.
  683.      - Added the VT100 Margin bell feature. See the new Margin Bell
  684.        item in the TERMINALcmenu.
  685.      - Added a blinking/non-blinking option for the cursor. If you are
  686.        using a parameter file from a previous version of Handshake,
  687.        the cursor will not blink initially. Go to the Cursor item of the
  688.        TERMINAL menu and select blinking. Now save your parameters. From
  689.        now on the cursor will blink again when you start Handshake.
  690.      - Speeded up CRC calculation for file transfers.
  691.      - Fixed a minor bug which caused XMODEM sends to always show 1 error
  692.        even there had not been one. This did not affect the transfer.
  693.      - Fixed a bug which sometimes caused inproper font selection after
  694.        going into VT52 mode and back out again.
  695.      - Fixed bug in UK Character set support.
  696.      - Speeded up CRC calculation for file transfers. I am now doing
  697.        bytewise instead of bitwise CRC calculation.
  698.  
  699. Version 1.30b
  700.     - Replaced the abort requesters with windows. The windows are used to
  701.       provide progress  information about file transfers and auto-dialing
  702.       as well as serving as abort devices. To abort a file transfer or
  703.       auto-dialing just click on the close gadget of the window in the
  704.       handshake screen.
  705.     - The windows described above are also duplicated on the Workbench
  706.       screen. This is so that you can do other things while a large file
  707.       transfer is in progress and not have to keep flipping back to
  708.       Handshake to see if it is finished yet. Same for auto-dialing.
  709.     - Relinked with a "tiny" _main.o so that the lattice standard input/
  710.       output window no longer pops up in the workbench screen.
  711.     - Capture mode (ASCII Receive) can now remain active during binary
  712.       file transfers. Handshake will suspend it until the transfer is
  713.       over and then start it up again.
  714.     - Added XMODEM/CRC file transfer mode.
  715.  
  716. Version 1.21a
  717.     - Local echo mode did not work properly. This has been fixed.
  718.     - Reseting the terminal would sometimes leave a double cursor on the
  719.     - Screen. This has been fixed.
  720.     
  721. Version 1.20a
  722.  
  723.     - Improved Workbench interface. Handshake will now optionally create
  724.       create Telephone icons for saved parameter files. This allows the
  725.       user to select which paramter file to use from the Workbench. The
  726.       icons can also be created in such a way that Handshake will
  727.       automatically start dialing a specified number when it is invoked
  728.       with that icon.
  729.     - Fixed a bug which caused XMODEM transmits to sometimes hang.
  730.     - Changed autodialing support so that it now works with modems that
  731.       report status while they are dialing (Like the Volksmodem 1200).
  732.     - Dialing destinations which contained spaces on the command line did
  733.       not work, even when enclosed in quotes. This has been fixed.
  734.     - Selecting the Reset Terminal option from the menu or typing Amiga-V
  735.       would cause two cursors to appear on the screen. This has been fixed.
  736.  
  737. Version 1.10a
  738.  
  739.     - At last, a real 132 columns instead of 128.
  740.     - Added some intelligence to the routines that display the cursor. This
  741.       yielded a 35% performance improvement. Handshake now has an average
  742.       throughput of about 875 characters per second.
  743.     - Cleaned up parsing of command line parameters especially the dialing
  744.       directory entry.
  745.     - Put error checking into reading of parameter files. If the file does
  746.       not exist or is of the wrong size put up a requester advising the
  747.       user. If the default file Handshake.parms cannot be found do not
  748.       annoy the user with a requester (use the built in defaults).
  749.     - The command line dialing direcotry entry is now case insensitive.
  750.     - Added some register variables in several places. Handshake is now
  751.       about six percent faster because of this.
  752.     - Fixed a bug which caused the line attribute for the bottom line to
  753.       not be reset when the screen was cleared.
  754.     - Fixed a hideous bug which caused the input subtask to lock up
  755.       sometimes. This would appear to the user as a blank title bar. This
  756.       would only happen if the user interface task sent a "go to sleep"
  757.       message to the serial input task at the same instant that an IO
  758.       completed, therefore this was more likely to happen at higher baud
  759.       rates. Sorry about that one.
  760.  
  761. Version 1.02a ( not released to the public at large ).
  762.     - Added command line parameters to specify parameter file to use, and
  763.       to allow the user to specify a remote computer to dial from the
  764.       command line.
  765.     - Added 20 second dialing timeout to the dial timeout menu.
  766.     - In order to abort redialing it was sometimes necessary to select the
  767.       abort requester more than once. This is now fixed.
  768.     - Moved File transfer and redialing abort requester to upper right
  769.       portion of screen.
  770.     - General cleanup of the file transfer code. Receiveing to disk is now
  771.       much faster. Transfer aborts now work porperly at high baud rates.
  772.  
  773. Version 1.01a
  774.     - Auto redialing added.
  775.     - Pulse/Dial menu option replaced with user definable dialing string.
  776.     - Added menu item to allow user to specify backspace & del key
  777.       operation.
  778.     - Fixed bug which caused menus to not be updated after a reset if
  779.       no parameter file was present.
  780.  
  781. Version 1.00a
  782.     - Handshake Unleashed on an unsuspecting public. An historic Moment!
  783.